Skip to main content

Finestra di dialogo: Configurazione input

Simbolo: _visu_icon_input_configuration.png

Funzione: La finestra di dialogo consente di assegnare un'azione di ingresso a un evento di ingresso e di configurare l'azione di ingresso.

Chiamata: Configura pulsante in Configurazione degli ingressi proprietà

Requisiti: Un elemento è selezionato nell'editor.

Sono disponibili tutte le proprietà degli elementi?

Tutte le proprietà sono disponibili solo dopo aver selezionato Avanzato opzione o Tutte le categorie filtrare Proprietà.

Azione di input: Gestione utenti

Dialoghi e azioni

Configura quale delle possibili finestre di dialogo di gestione degli utenti o quale azione segue l'evento di input

Nota

La finestra di dialogo utilizzata in fase di esecuzione è configurata in Impostazioni di dialogo scheda di Gestione visualizzazioni.

. Guarda anche
  • Finestra di dialogo di accesso

  • Finestra di dialogo Modifica password

  • Finestra di dialogo Modifica configurazione

Predefinito: finestre di dialogo da VisuUserManagement biblioteca

Login

Si apre la richiesta di accesso.

Predefinito: VisuUserManagement.VUM_Login in Finestra di dialogo di accesso

Disconnettersi

L'utente corrente è disconnesso.

Modifica password utente

Si apre la finestra di dialogo per la modifica della password.

Predefinito: VisuUserManagement.VUM_ChangePassword in Finestra di dialogo Modifica password

Apri Configurazione utente

Si apre la finestra di dialogo per modificare la configurazione.

Predefinito: VisuUserManagement.VUM_UserManagement in Finestra di dialogo Modifica configurazione

Azione di input: Chiudi finestra

Dialogo

La visualizzazione del tipo Dialogo che sarà chiuso

_visu_icon_open_list.png: Casella di riepilogo con tutto Dialogo digitare le visualizzazioni disponibili nel progetto

Esempio:

. Finestre di dialogo predefinite di VisuDialogs libreria, che di solito è integrata nel progetto.
  • FileOpenSave

  • Keypad

  • Login

  • Numpad

  • NumpadExtended

  • TextinputWithLimits

Nota

L'impostazione nella proprietà dell'oggetto (Visualizzazione tab) di una visualizzazione determina se una visualizzazione può essere utilizzata o meno come finestra di dialogo.

Risultato

Valore restituito per la chiusura della finestra di dialogo

Nota

Se sono presenti più azioni di input dopo la chiusura, sono state configurate in Configurazione ingresso → OnDialogClosed proprietà dell'elemento.

Nessuno

standard icon: Nessun valore di ritorno

ok

standard icon: Viene restituito il valore di ritorno impostato.

Il valore restituito si riferisce al pulsante nella finestra di dialogo. Il valore OK viene restituito per il pulsante OK. Il valore Cancel viene restituito per il pulsante Annulla.

Annulla

Aborto

Riprova

Ignorare

No

Azione di input: Apri finestra di dialogo

Dialogo

Nome della visualizzazione (digitare: Dialogo) che si aprirà come finestra di dialogo in fase di esecuzione dopo che l'azione di input è stata attivata dall'utente della visualizzazione

_visu_icon_open_list.png: Casella di riepilogo con tutte le finestre di dialogo disponibili nel progetto.

Nota

Il VisuDialogs libreria fornisce finestre di dialogo standard.

  • VisuDialogs.FileOpenSave

  • VisuDialogs.Login

Trasferisci i parametri della finestra di dialogo

Parametri

Parametro di interfaccia come dichiarato nell'editor di interfaccia della visualizzazione

Esempio: filelistProvider

Tipo

Tipo di dati del parametro come dichiarato nell'editor di interfaccia della visualizzazione

Esempio: VISU_FBFILELISTPROVIDER

Valore

Variabile (il tipo di dati corrisponde al tipo di dati del parametro)

Il valore della variabile viene passato al parametro quando si apre la finestra di dialogo.

Esempio: PLC_PRG.fileListProvider // Instance of function block VisuDialogs.Visu_FbFileListProvider

_visu_icon_open_input_assistant.png: L'Input Assistant offre tutte le variabili disponibili nell'intero progetto.

Qui viene attivato il valore di ritorno della finestra di dialogo per cui il Var_OUTPUT variabile e VAR_IN_OUT vengono scritte le variabili. La finestra di dialogo si chiude in seguito.

Aggiornare_cds_icon_output_channel.pnge_visu_icon_inout_parameter.pngin caso di risultato

Nota

I parametri vengono aggiornati prima della chiusura della finestra di dialogo. Fino ad allora, i valori vengono memorizzati temporaneamente. Sono archiviati come copia, non come riferimento.

Nessuno

standard icon: Nessun valore di ritorno

ok

standard icon: Definisce il valore di ritorno per il quale viene scritto il parametro di trasferimento

Annulla

Aborto

Riprova

Ignorare

No

Apri finestra di dialogo modale

standard icon: In runtime, solo la finestra di dialogo elabora l'input dell'utente. L'input dell'utente che si verifica al di fuori della finestra di dialogo viene ignorato. L'interfaccia utente è bloccata.

Posizione da aprire

Posizione iniziale della finestra di dialogo di apertura relativa alla visualizzazione chiamante

Centrato

_cds_icon_radiobutton_activated.png: La finestra di dialogo viene visualizzata al centro.

Posizione

_cds_icon_radiobutton_activated.png: La finestra di dialogo viene visualizzata nella posizione impostata di seguito.

Nota: utilizzare le opzioni di input corrispondenti per specificare la posizione nella direzione X e nella direzione Y.

X

Posizione X orizzontale per l'angolo in alto a sinistra della finestra di dialogo di apertura

Opzioni di inserimento:

  • Fisso (in pixel)

  • Come variabile IEC (tipo di dati intero)

  • Segnaposto: ElementRectangle.ptTopLeft.iX

    Il segnaposto viene sostituito dalla posizione dell'angolo superiore sinistro dell'elemento.

  • Segnaposto:ElementRectangle.ptBottomRight.iX

    Il segnaposto viene sostituito dalla posizione dell'angolo inferiore destro dell'elemento.

Y

Posizione Y verticale per l'angolo in alto a sinistra della finestra di dialogo di apertura

Opzioni di inserimento:

  • Fisso (in pixel)

  • Come variabile IEC (tipo di dati intero)

  • Segnaposto: ElementRectangle.ptTopLeft.iY

    In fase di esecuzione, la finestra di dialogo viene visualizzata nella posizione dell'angolo superiore sinistro dell'elemento chiamante

  • Segnaposto:ElementRectangle.ptBottomRight.iY

    Il segnaposto viene sostituito dalla posizione dell'angolo inferiore destro dell'elemento.

Azione di input: Cambia lingua

Lingua dipendente dal client

La lingua può essere cambiata individualmente per ogni cliente. Il requisito è che il CODESYS Visualization l'add-on è installato almeno nella versione 4.7.0.0 e il sistema runtime nella versione >= V3.5 SP20. Quando la visualizzazione viene avviata, viene visualizzata nella lingua impostata nel browser (ad esempio, di O esso). Questa lingua deve essere disponibile nel progetto. Se la lingua non è disponibile, vengono visualizzati i testi predefiniti.

Nella versione 4.6.0.0 e precedenti, la lingua è stata modificata simultaneamente per tutti i client.

Codice lingua

Utilizzare il codice ISO 639 (ad esempio, de, en, it, zh-CHS) per nominare una lingua presente nella visualizzazione.

Lingua

Lingua in cui è stato commutato il client di visualizzazione corrente

Esempio: en

_visu_icon_open_input_assistant.png: L'Assistente di immissione offre tutte le lingue disponibili nel progetto.

Azione di input: Modifica visualizzazione mostrata

Tabella 110. Zoom su visualizzazione

Visualizzazione che viene mostrata all'input dell'utente

Assegnare

Visualizzazione selezionata da tutte le visualizzazioni disponibili nel progetto o nelle librerie.

Esempio: visMain

Assegna espressione

variabile (STRING) che contiene il nome della visualizzazione

Esempio: PLC_PRG.strVisu per il seguente codice dell'applicazione: strVisu: STRING := 'visMain';

L'ordine in cui le visualizzazioni vengono visualizzate dagli input dell'utente viene salvato internamente. Le seguenti opzioni utilizzano queste informazioni.

Visualizzazione precedente mostrata

standard icon: Visualizzazione che è già stata mostrata prima di quella corrente

Presupposto: è già avvenuta una commutazione di visualizzazione.

Visualizzazione successiva mostrata

standard icon: Visualizzazione successiva nell'ordine di chiamata dopo quello corrente

Presupposto: è già intervenuto un interruttore di visualizzazione che è stato richiamato da Visualizzazione precedente mostrata.



Azione di input: Esegui comando

I comandi sono elencati qui con i parametri di trasferimento che la visualizzazione elabora quando si verifica un evento di input.

Configura i comandi

_visu_icon_open_list.png
  • Eseguire il programma sul plc

  • Eseguire il programma sul client

  • Stampa

  • Vai all'URL (WebVisu)

  • Crea Ricetta

  • Leggi Ricetta

  • Scrivi Ricetta

  • Scrivi la ricetta nel file

  • Carica ricetta da file

  • Elimina Ricetta

Clicca il _visu_icon_add.png simbolo per aggiungere il comando selezionato all'elenco comandi inferiore.

_visu_icon_add.png

Il comando dentro Configura i comandi viene aggiunto all'elenco.

_visu_icon_remove_command.png

Il comando viene rimosso.

Requisito: è selezionato un comando.

L'ordine nell'elenco definisce l'ordine di esecuzione.

_visu_icon_down_command.png

Il comando selezionato viene spostato in basso di una posizione nell'elenco.

_visu_icon_up_command.png

Il comando selezionato viene spostato in alto di una posizione nell'elenco.

Tabella 111. Comando: esegue il programma sul plc

Comando

1° parametro

2° parametro

ExecutePlcProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

File EXE che viene eseguito sul controller

Il programma viene eseguito sul PLC e quindi non deve essere interattivo né avere interfacce utente.

È possibile, ad esempio, che un programma copi un file.

Nome del programma con directory come stringa tra virgolette singole

Argomenti del programma come stringa tra virgolette singole diritte

Esempio: nome del file che il programma apre



Tabella 112. Comando: esegue il programma sul client

Comando

1. Parametri

2. Parametri

ExecuteClientProgram

'C:\programs\notepad.exe'

'Notes_A.txt'

File EXE che viene eseguito sulla variante di visualizzazione. Eccezione: WebVisu.

Il programma viene eseguito nel contesto della variante di visualizzazione. Successivamente, il programma potrebbe essere interattivo e disporre di un'interfaccia utente.

Nome del programma con directory come STRING tra virgolette singole diritte

Argomenti del programma come STRING tra virgolette singole diritte

Esempio: nome del file che il programma apre



Importante

Se la visualizzazione viene visualizzata come a CODESYS WebVisu, allora nessun programma (file EXE) può essere avviato.

Tabella 113. Comando: vai all'URL (WebVisu)

Comando

1. Parametri

2. Parametri

NavigateURL

'http://en.wikipedia.org'

PLC_PRG.stURL

'replace'

La visualizzazione passa alla pagina Web dell'URL.

Requisito: la visualizzazione viene eseguita come a CODESYS WebVisu.

. URL
  • Come un letterale tra virgolette singole diritte

  • Come variabile (STRING)

Se non viene specificato un parametro, la pagina Web viene visualizzata in una nuova finestra o in una nuova scheda.

Se 'replace' viene specificato, quindi il CODESYS WebVisu è sostituito dalla pagina web.



Tabella 114. Comando: leggi la ricetta

Comando

1° parametro

2° parametro

ReadRecipe

'RecipeDefinitionForModules'

'RecipeModuleA'

. Nome della definizione della ricetta
  • Come letterale

  • Come variabile (STRING)

. Nome della ricetta
  • Come letterale

  • Come variabile (STRING)

Durante il runtime di visualizzazione, il controllore legge i valori effettivi dalle variabili della definizione della ricetta e li scrive nella ricetta specificata. I valori vengono salvati in modo implicito (in un file sul controller) e visualizzati nella definizione della ricetta nel Recipe Manager di CODESYS. In altre parole, la ricetta in cui viene gestita CODESYS viene aggiornato con i valori del controller.



Tabella 115. Comando: Scrivi Ricetta

Comando

1. Parametri

2. Parametri

WriteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nome della definizione della ricetta interessata
  • Come letterale

  • Come variabile (STRING)

. Nome della ricetta (dalla definizione della ricetta)
  • Come letterale

  • Come variabile (STRING)

Durante il runtime di visualizzazione, i valori della ricetta vengono scritti nelle variabili sul controllore così come nel Recipe Manager.



Tabella 116. Comando: Salva Ricetta in File

Comando

1. Parametri

2. Parametri

SaveRecipeAs

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nome della definizione della ricetta interessata
  • Come letterale

  • Come variabile (STRING)

. Nome della ricetta interessata che viene aggiornata e salvata in un file
  • Come letterale

  • Come variabile (STRING)

Parametro opzionale: se qui non si specifica un parametro di trasferimento, i valori delle variabili della ricetta vengono salvati solo nel file specificato successivamente. I file delle ricette implicite non vengono aggiornati.

In fase di visualizzazione, il Salva Ricetta con nome si apre la finestra di dialogo e richiede all'utente un nome file e una posizione di archiviazione sul controller. Il nome del file non deve essere <recipe>.<recipe definition>. L'estensione del file è .txtrecipe.

L'utente può quindi salvare il file che include i valori effettivi dalle variabili della ricetta. Se un parametro di trasferimento è non specificato nel 2° parametro, il file viene salvato senza modificare un file ricetta implicito. Se nel 2° parametro viene fornito un parametro di trasferimento, viene aggiornato anche il file della ricetta implicita.

Nota: se il Salva automaticamente le modifiche alle ricette nei file delle ricette l'opzione è selezionata in Responsabile delle ricette – Generale scheda, quindi la definizione della ricetta in CODESYS e i file delle ricette implicite vengono mantenuti gli stessi automaticamente.

Nota: sul controller esistono file di ricetta impliciti (generati automaticamente) con nomi nella seguente sintassi: <recipe>.<recipe definition>.txtrecipe. Questi sono in genere utilizzati nell'applicazione come buffer durante la lettura e la scrittura di variabili di ricetta.



Tabella 117. Comando: Carica ricetta da file

Comando

1° parametro

2° parametro

LoadRecipeFrom

PLC_PRG.stReccipeDef

PLC_PRG.stReccipe

. Nome della definizione della ricetta interessata
  • Come letterale

  • Come variabile (STRING)

. Nome della ricetta interessata
  • Come letterale

  • Come variabile (STRING)

In fase di visualizzazione, il Carica ricetta si apre la finestra di dialogo. Fornisce all'utente della visualizzazione un elenco di file che si trova nel file system del controller e filtra in base all'estensione txtrecipe. Il file selezionato viene scaricato. Quindi le ricette dal file vengono scritte nei file impliciti e lette nella ricetta data nella definizione della ricetta di Recipe Manager.

Requisito: il file è stato creato con il SaveRecipeAs comando.



Tabella 118. Comando: Crea Ricetta

Comando

1. Parametri

2. Parametri

CreateRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe_New

. Nome della definizione della ricetta interessata
  • Come letterale

  • Come variabile (STRING)

. Nome della nuova ricetta
  • Come letterale

  • Come variabile (STRING)

Durante il runtime di visualizzazione viene creata una nuova ricetta nella definizione della ricetta indicata.



Tabella 119. Comando: Elimina Ricetta

Comando

1. Parametri

2. Parametri

DeleteRecipe

PLC_PRG.stRecipeDef

PLC_PRG.stRecipe

. Nome della definizione della ricetta interessata
  • Come letterale

  • Come variabile (STRING)

. Nome della ricetta
  • Come letterale

  • Come variabile (STRING)

Durante il runtime di visualizzazione la ricetta indicata viene cancellata dalla definizione della ricetta.



Tabella 120. Comando: stampa

Comando

1. Parametri

2. Parametri

Print

Opzionale: Nome file per la schermata di visualizzazione da stampare (esempio: "Schermata iniziale")

Non è possibile specificare un secondo parametro per il Print comando.

Il predefinito Stampante viene aperta la finestra di dialogo durante l'esecuzione della visualizzazione. Nella finestra di dialogo, si seleziona una stampante e si configurano impostazioni di stampa aggiuntive. Quando si conferma la finestra di dialogo, viene stampata la schermata di visualizzazione attualmente visualizzata.

Nota

Il comando può essere eseguito solo in TargetVisu.



Azione di input: cambia visualizzazione frame

Quando si verifica l'evento di input, il display passa a un'altra visualizzazione all'interno di un frame.

Tipo di selezione della cornice

Cambia visualizzazione locale

Il Selezione della cornice il gruppo è visibile.

Passa a qualsiasi visualizzazione

Il Selezione cornice e visualizzazione il gruppo è visibile.

Requisiti: Cambia visualizzazione locale è selezionato.

Selezione della cornice

Elenco di tutti i frame che contengono la visualizzazione attiva. Le visualizzazioni di riferimento sono elencate sotto ogni frame, come determinato nel Riferimenti proprietà del rispettivo frame.

Esempio:

_visu_img_frame_selection.png

Assegna selezione

La selezione nel Selezione della cornice campo di immissione è accettato. Quindi appare nel Cornice selezionata e Visualizzazione selezionata impostazioni.

Requisito: una visualizzazione è selezionata in Selezione della cornice Campo di inserimento.

Cornice selezionata

Nome del frame in cui passare

Esempio: MainArea

Suggerimento: usa il Assegna selezione comando per modificare l'impostazione qui.

Visù selezionato

Nome della visualizzazione commutata

Esempio: visMainArea

Suggerimento: usa il Assegna selezione comando per modificare l'impostazione qui.

Requisito: il Passa a qualsiasi visualizzazione l'opzione è selezionata.

Selezione cornice e visualizzazione

Contiene la cornice a cui passare

Assegnare

Frame da commutare (con percorso completo). L'indice determina la visualizzazione.

Esempio: visMain.frameA.visB.frameB

Il percorso è specificato nella seguente sintassi: <visualization name>.<frame name> { <visualization name>.<frame name> }

Attenzione: le visualizzazioni possono essere annidate a qualsiasi profondità per mezzo di elementi frame. Per utilizzare il Passa a qualsiasi visualizzazione tipo di selezione frame senza problemi, un frame non deve contenere più di 21 visualizzazioni referenziate.

Assegna espressione

variabile (STRING) per il percorso del frame da commutare

Esempio: strFrane: STRING := 'visMain.frameA.visB.frameB';

Indice da selezionare

. Indice che determina quale delle visualizzazioni di riferimento viene visualizzata
  • Come numero intero

  • Come variabile (tipo di dati intero)

    Esempio :PLC_PRG.iIndex

Nota: le visualizzazioni di riferimento di un frame vengono indicizzate automaticamente in base al loro ordine.

Requisito: il progetto contiene visualizzazioni che formano una struttura.

Azione di input: Scrivi variabile

La configurazione dell'azione di input definisce come un utente della visualizzazione specifica un valore e in quale variabile viene scritto il valore.

Tipo di ingresso

Come viene richiesto l'input

Predefinito

Campo di inserimento, o se necessario una tastiera virtuale (se la variante display non dispone di una tastiera fisica)

Nota: l'opzione predefinita per l'immissione di testo in fase di esecuzione è impostata in Visualization Manager: Impostazioni di dialogo scheda, Impostazioni per l'immissione di testo predefinita.

L'immissione di testo

Viene visualizzato un campo di immissione. In qualità di utente della visualizzazione, è possibile utilizzare la tastiera per specificare un numero o un testo.

Presupposto: la variante di display dispone di una tastiera come dispositivo di input.

Inserimento di testo con limiti

Viene visualizzato un campo di immissione. Utilizzare la tastiera per specificare un numero o un testo. Il campo mostra anche l'intervallo di valori per l'ingresso. Quando viene superato un limite, il valore immesso viene visualizzato in rosso.

Presupposto: la variante di display dispone di una tastiera come dispositivo di input.

VisuDialogs.Tastiera

Si apre una tastiera virtuale. Lo usi per specificare un numero o un testo.

VisuDialogs.Numpad

Si apre una tastiera virtuale. Lo usi per specificare un numero.

VisuDialogs.NumpadExtended

Si apre una tastiera virtuale. Lo usi per specificare un numero. Qui sono consentite anche la notazione esadecimale ed esponenziale.

Scegli la variabile da modificare

Usa la variabile di output del testo

_cds_icon_radiobutton_activated.png: Il valore di input viene scritto nella variabile di output di testo dell'elemento. Questa è la variabile assegnata in Variabile di testo → Testo proprietà.

Usa un'altra variabile

_cds_icon_radiobutton_activated.png: variabile in cui viene scritto il valore di input.

Esempio: PLC_PRG.iVariable

Formato di visualizzazione iniziale

Segnaposto con definizione del formato. Definisce il formato di output per il valore della variabile e i limiti di input.

Esempio: %2.3f per visualizzare il valore come frazione decimale.

min

. Valore minimo del limite di input. Se un utente specifica un valore minore, non viene accettato.
  • Come valore fisso

  • Come variabile (il tipo di dati corrisponde alla variabile selezionata)

Massimo

. Valore massimo del limite di input. Se un utente specifica un valore maggiore, non viene accettato.
  • Come valore fisso

  • Come variabile (il tipo di dati corrisponde alla variabile selezionata)

Titolo del dialogo

. Testo visualizzato nella barra del titolo della finestra di dialogo. Opzionale.
  • Come una stringa fissa

    Esempio: Insert value

  • Come variabile (STRING)

    Esempio: PLC_PRG.stTitle : STRING := 'Insert value';

Campo password

standard icon: *** viene visualizzato al posto del testo di input.

Posizione per aprire la finestra di dialogo di input

Posizione iniziale per la finestra di dialogo di input di apertura relativa alla visualizzazione chiamante

Usa l'impostazione globale (da Visualization Manager)

Requisito: questa opzione è disponibile solo quando viene visualizzata su un TargetVisu o come WebVisu.

_cds_icon_radiobutton_activated.png: La posizione impostata in Visualizzati Manager su Impostazioni della finestra di dialogo viene utilizzata la scheda.

Centrato

_cds_icon_radiobutton_activated.png: La finestra di dialogo viene visualizzata al centro.

Posizione

_cds_icon_radiobutton_activated.png: La finestra di dialogo viene visualizzata nella posizione impostata di seguito.

Nota: utilizzare le opzioni di input corrispondenti per specificare la posizione nella direzione X e nella direzione Y.

X

Posizione X orizzontale per l'angolo in alto a sinistra della finestra di dialogo di apertura

Opzioni di inserimento:

  • Fisso (in pixel)

  • Come variabile IEC (tipo di dati intero)

  • Segnaposto: ElementRectangle.ptTopLeft.iX

    Il segnaposto viene sostituito dalla posizione dell'angolo superiore sinistro dell'elemento.

  • Segnaposto:ElementRectangle.ptBottomRight.iX

    Il segnaposto viene sostituito dalla posizione dell'angolo inferiore destro dell'elemento.

Y

Posizione Y verticale per l'angolo in alto a sinistra della finestra di dialogo di apertura

Opzioni di inserimento:

  • Fisso (in pixel)

  • Come variabile IEC (tipo di dati intero)

  • Segnaposto: ElementRectangle.ptTopLeft.iY

    Il segnaposto viene sostituito dalla posizione dell'angolo superiore sinistro dell'elemento.

  • Segnaposto:ElementRectangle.ptBottomRight.iY

    Il segnaposto viene sostituito dalla posizione dell'angolo inferiore destro dell'elemento.

Azione di input: Esegui codice ST

Campo di inserimento

Editor per codice come testo strutturato

Azione di input: attiva/disattiva variabile

Variabile

variabile (BOOL) che viene attivato quando si verifica l'evento di input

Esempio: PLC_PRG.bSwitch

Azione di input: Trasferimento file

Con il Trasferimento di file azione di input, un file può essere trasferito da una variante operativa (destinazione o visualizzazione Web) al controllore nonché da e verso il controllore. Funziona sia tramite un trasferimento di file (Tipo: File) o in streaming (Tipo: Streaming).

L'azione ha l'effetto di visualizzare una finestra di dialogo per la selezione dei file nella visualizzazione in fase di esecuzione. Lì l'utente della visualizzazione può selezionare un file che verrà trasferito al o dal PLC: Per un trasferimento da un PLC alla visualizzazione, il Salvare il file si apre la finestra di dialogo. Per il trasferimento dalla visualizzazione al PLC, il Apri il file si apre la finestra di dialogo.

Trasferimento

Direzione

Direzione del trasferimento dei file

Dal PLC alla visualizzazione

L'oggetto specificato in Nome del file o Nome dell'istanza di streaming viene trasferito dal PLC alla visualizzazione.

Il Salvare il file la finestra di dialogo per la selezione dei file viene visualizzata nella visualizzazione in fase di esecuzione.

Dalla visualizzazione al PLC

Il file specificato dall'utente della visualizzazione viene trasferito al PLC e salvato nel percorso file specificato in Nome del file o Nome dell'istanza di streaming.

Il Apri il file la finestra di dialogo per la selezione dei file viene visualizzata nella visualizzazione in fase di esecuzione.

Tipo

. Determina come viene trasferito il file
  • Tipo di trasferimento File: Con trasferimento di file

  • Tipo di trasferimento Streaming: In streaming

Tipo

File

Il trasferimento dei dati avviene tramite trasferimento di file.

Nome del file

Percorso del file (tipo STRING) che descrive il file nel file system

  • Variabile

    Esempio: strTransferFile: STRING;

  • Letterale con percorso relativo

    Esempio: '/Recipes/Recipe_1.txt' salva il file nella directory Recipes.

  • Letterale con segnaposto $PLCLOGIC$

    PlcLogic è la risoluzione predefinita per il segnaposto della directory $PLCLOGIC$.

    Esempio: '$$PLCLOGIC$$/test.txt' salva il file nella directory PlcLogic.

    Esempio: '$$PLCLOGIC$$/MyData/test.txt' salva il file nella directory PlcLogic/MyData.

  • Letterale con segnaposto $VISU$

    visu è la risoluzione predefinita per il segnaposto $VISU$.

    Esempio: '$$VISU$$/test.txt' salva il file nella sottodirectory PlcLogic/visu. In alternativa, 'visu/test.txt' può anche essere specificato.

  • Letterale con percorso assoluto

    Esempio: 'E:\temp\test.txt'

    Nota: questi tipi di percorsi di file non sono sempre supportati.

Nota

Se un utente specifica il percorso del file nella visualizzazione tramite a Campo di testo elemento, il carattere mascherante $ non devono essere inclusi: $VISU$/dummy.txt

Nota

Nel caso in cui il percorso del file sia specificato dall'utente, dovrebbe essere verificato dall'applicazione per evitare che i file vengano letti o sovrascritti accidentalmente.

Tipo

Streaming

Il trasferimento dei dati avviene in streaming.

Nome dell'istanza di streaming

Percorso dell'istanza (tipo IVisuStreamWriter o IVisuStreamReader) che descrive l'oggetto nel file system del controller

Tipo IVisuStreamReader per la direzione del trasferimento Dal PLC alla visualizzazione

Tipo IVisuStreamWriter per la direzione del trasferimento Dalla visualizzazione al PLC

Bandiere di controllo

Nota: la variabile viene valutata solo per la direzione di trasferimento Dalla visualizzazione al PLC.

Variabile (tipo DWORD)

Determina la modalità di gestione dell'oggetto (file o oggetto istanza) nel file system del PLC. Per questo sono previsti due flag con i quali è possibile impostare la variabile.

  • Bandiera 1: VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName

  • Bandiera 2: VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc

. Opzioni
  • Nessun flag impostato:

    L'utente seleziona un file che viene salvato nel percorso specificato in Nome del file o Nome dell'istanza di streaming.

  • La bandiera 1 è impostata:

    Il percorso, che viene specificato dall'utente al runtime di visualizzazione, viene applicato e utilizzato come percorso nel file system del PLC.

  • Entrambi i flag sono impostati:

    Viene verificato anche il percorso. Se esiste già un oggetto nel percorso specificato sul lato client, nella visualizzazione viene visualizzato un messaggio di richiesta. Lì l'utente della visualizzazione può confermare che il file verrà sovrascritto.

Esempio: dwControlFlag

Esempio 49. Esempio

La direzione del trasferimento è Dalla visualizzazione al PLC (scrivere).

Esempio: un nuovo file di ricetta Recipes/Recipe_2021.txt è stato creato nel dispositivo di visualizzazione. L'utente della visualizzazione seleziona questo file e desidera salvare il file sul PLC con lo stesso nome. Poiché i flag di controllo sono impostati di conseguenza, si apre una finestra di messaggio e l'utente della visualizzazione può confermare che il file verrà sovrascritto.

PROGRAM PLC_PRG
VAR
    xVisuToggle : BOOL;
    dwControlFlag : DWORD := VisuElems.VisuEnumFileTransferControlFlags.UseOriginalFileName
                             + VisuElems.VisuEnumFileTransferControlFlags.ConfirmFileOverwriteInPlc;
    strFileName: STRING := '/Recipes/Recipe_new.txt';
END_VAR


Variabili di stato

Trasferimento attivo

Variabile booleana (opzionale)

TRUE: Il trasferimento è in corso.

Trasferimento riuscito

Variabile booleana (opzionale)

TRUE: Il trasferimento è stato completato con successo.

Codice di errore

  • 0: Nessun errore

  • 1: Errore non specificato

  • 2: Annullamento della finestra di dialogo del file

  • 3: altro trasferimento di file in corso

  • 4: Errore durante il trasferimento del file

  • 5: Cancellazione per timeout

  • 6: Errore di lettura del file – Il file non è disponibile o non può essere letto.

  • 7: Nessun supporto del dispositivo per il trasferimento di file

    Cause possibili:

  • CODESYS WebVisu: Il trasferimento di file non è possibile per impostazione predefinita.

  • Comunicazione con un controller di una versione < 3.5.11: Funzionalità non implementata.

  • Comunicazione con un controllore di una versione >= 3.5.11: Trasferimento file non attivato (descrizione dispositivo).

    Suggerimento

    CODESYS gestisce questa impostazione nelle impostazioni del progetto.

Usa file di visualizzazione locali

Requisito: l'opzione è disponibile quando Trasferire i file di visualizzazione al PLC è stata specificata come direzione.

  • _cds_icon_option_deactivated.png: Viene immediatamente visualizzata la finestra di selezione file del sistema operativo (impostazione predefinita per un'azione di input creata di recente).

  • _cds_icon_option_black_activated.png: si apre la finestra di dialogo di trasferimento file, disponibile per impostazione predefinita, che richiede di selezionare un file. Puoi adattare la finestra di dialogo.

    Suggerimento: è possibile che la finestra di dialogo sia visualizzata in una posizione scomoda e che il layout della finestra di dialogo non corrisponda a quello dell'interfaccia della visualizzazione web.